package com.videoweb.service;

import com.videoweb.entity.Role;
import com.baomidou.mybatisplus.extension.service.IService;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;

import java.util.List;
import java.util.Set;

/**
 * <p>
 *  角色服务类
 * </p>
 *
 * @author lmr
 * @since 2025-05-17
 */
public interface IRoleService extends IService<Role> {

    /**
     * 查询角色列表
     * @param role 角色信息
     * @return 角色列表
     */
    List<Role> selectRoleList(Role role);

    /**
     * 分页查询角色列表
     * @param page 分页参数
     * @param role 角色信息
     * @return 角色列表
     */
    IPage<Role> selectRolePage(Page<Role> page, Role role);

    /**
     * 根据用户ID查询角色权限
     * @param userId 用户ID
     * @return 角色列表
     */
    Set<String> selectRolePermissionByUserId(Long userId);

    /**
     * 根据用户ID查询角色
     * @param userId 用户ID
     * @return 角色列表
     */
    List<Role> selectRolesByUserId(Long userId);

    /**
     * 查询所有角色
     * @return 角色列表
     */
    List<Role> selectRoleAll();

    /**
     * 根据角色ID查询角色
     * @param roleId 角色ID
     * @return 角色对象信息
     */
    Role selectRoleById(Long roleId);

    /**
     * 校验角色名称是否唯一
     * @param role 角色信息
     * @return 结果
     */
    boolean checkRoleNameUnique(Role role);

    /**
     * 校验角色权限是否唯一
     * @param role 角色信息
     * @return 结果
     */
    boolean checkRoleKeyUnique(Role role);

    /**
     * 校验角色是否允许操作
     * @param role 角色信息
     */
    void checkRoleAllowed(Role role);

    /**
     * 通过角色ID查询角色使用数量
     * @param roleId 角色ID
     * @return 结果
     */
    int countUserRoleByRoleId(Long roleId);

    /**
     * 新增保存角色信息
     * @param role 角色信息
     * @return 结果
     */
    boolean insertRole(Role role);

    /**
     * 修改保存角色信息
     * @param role 角色信息
     * @return 结果
     */
    boolean updateRole(Role role);

    /**
     * 修改角色状态
     * @param role 角色信息
     * @return 结果
     */
    boolean updateRoleStatus(Role role);

    /**
     * 修改数据权限信息
     * @param role 角色信息
     * @return 结果
     */
    boolean authDataScope(Role role);

    /**
     * 通过角色ID删除角色
     * @param roleId 角色ID
     * @return 结果
     */
    boolean deleteRoleById(Long roleId);

    /**
     * 批量删除角色信息
     * @param roleIds 需要删除的角色ID
     * @return 结果
     */
    boolean deleteRoleByIds(Long[] roleIds);
}
